# Copyright 2020 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

require 'date'
require 'google/apis/core/base_service'
require 'google/apis/core/json_representation'
require 'google/apis/core/hashable'
require 'google/apis/errors'

module Google
  module Apis
    module SpeechV1
      
      # 
      class AbnfGrammar
        include Google::Apis::Core::Hashable
      
        # All declarations and rules of an ABNF grammar broken up into multiple strings
        # that will end up concatenated.
        # Corresponds to the JSON property `abnfStrings`
        # @return [Array<String>]
        attr_accessor :abnf_strings
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @abnf_strings = args[:abnf_strings] if args.key?(:abnf_strings)
        end
      end
      
      # An item of the class.
      class ClassItem
        include Google::Apis::Core::Hashable
      
        # The class item's value.
        # Corresponds to the JSON property `value`
        # @return [String]
        attr_accessor :value
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @value = args[:value] if args.key?(:value)
        end
      end
      
      # Message sent by the client for the `CreateCustomClass` method.
      class CreateCustomClassRequest
        include Google::Apis::Core::Hashable
      
        # A set of words or phrases that represents a common concept likely to appear in
        # your audio, for example a list of passenger ship names. CustomClass items can
        # be substituted into placeholders that you set in PhraseSet phrases.
        # Corresponds to the JSON property `customClass`
        # @return [Google::Apis::SpeechV1::CustomClass]
        attr_accessor :custom_class
      
        # Required. The ID to use for the custom class, which will become the final
        # component of the custom class' resource name. This value should restrict to
        # letters, numbers, and hyphens, with the first character a letter, the last a
        # letter or a number, and be 4-63 characters.
        # Corresponds to the JSON property `customClassId`
        # @return [String]
        attr_accessor :custom_class_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @custom_class = args[:custom_class] if args.key?(:custom_class)
          @custom_class_id = args[:custom_class_id] if args.key?(:custom_class_id)
        end
      end
      
      # Message sent by the client for the `CreatePhraseSet` method.
      class CreatePhraseSetRequest
        include Google::Apis::Core::Hashable
      
        # Provides "hints" to the speech recognizer to favor specific words and phrases
        # in the results.
        # Corresponds to the JSON property `phraseSet`
        # @return [Google::Apis::SpeechV1::PhraseSet]
        attr_accessor :phrase_set
      
        # Required. The ID to use for the phrase set, which will become the final
        # component of the phrase set's resource name. This value should restrict to
        # letters, numbers, and hyphens, with the first character a letter, the last a
        # letter or a number, and be 4-63 characters.
        # Corresponds to the JSON property `phraseSetId`
        # @return [String]
        attr_accessor :phrase_set_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @phrase_set = args[:phrase_set] if args.key?(:phrase_set)
          @phrase_set_id = args[:phrase_set_id] if args.key?(:phrase_set_id)
        end
      end
      
      # A set of words or phrases that represents a common concept likely to appear in
      # your audio, for example a list of passenger ship names. CustomClass items can
      # be substituted into placeholders that you set in PhraseSet phrases.
      class CustomClass
        include Google::Apis::Core::Hashable
      
        # Output only. Allows users to store small amounts of arbitrary data. Both the
        # key and the value must be 63 characters or less each. At most 100 annotations.
        # This field is not used.
        # Corresponds to the JSON property `annotations`
        # @return [Hash<String,String>]
        attr_accessor :annotations
      
        # If this custom class is a resource, the custom_class_id is the resource id of
        # the CustomClass. Case sensitive.
        # Corresponds to the JSON property `customClassId`
        # @return [String]
        attr_accessor :custom_class_id
      
        # Output only. The time at which this resource was requested for deletion. This
        # field is not used.
        # Corresponds to the JSON property `deleteTime`
        # @return [String]
        attr_accessor :delete_time
      
        # Output only. User-settable, human-readable name for the CustomClass. Must be
        # 63 characters or less. This field is not used.
        # Corresponds to the JSON property `displayName`
        # @return [String]
        attr_accessor :display_name
      
        # Output only. This checksum is computed by the server based on the value of
        # other fields. This may be sent on update, undelete, and delete requests to
        # ensure the client has an up-to-date value before proceeding. This field is not
        # used.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # Output only. The time at which this resource will be purged. This field is not
        # used.
        # Corresponds to the JSON property `expireTime`
        # @return [String]
        attr_accessor :expire_time
      
        # A collection of class items.
        # Corresponds to the JSON property `items`
        # @return [Array<Google::Apis::SpeechV1::ClassItem>]
        attr_accessor :items
      
        # Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-
        # hierarchy#keys) with which the content of the ClassItem is encrypted. The
        # expected format is `projects/`project`/locations/`location`/keyRings/`key_ring`
        # /cryptoKeys/`crypto_key``.
        # Corresponds to the JSON property `kmsKeyName`
        # @return [String]
        attr_accessor :kms_key_name
      
        # Output only. The [KMS key version name](https://cloud.google.com/kms/docs/
        # resource-hierarchy#key_versions) with which content of the ClassItem is
        # encrypted. The expected format is `projects/`project`/locations/`location`/
        # keyRings/`key_ring`/cryptoKeys/`crypto_key`/cryptoKeyVersions/`
        # crypto_key_version``.
        # Corresponds to the JSON property `kmsKeyVersionName`
        # @return [String]
        attr_accessor :kms_key_version_name
      
        # The resource name of the custom class.
        # Corresponds to the JSON property `name`
        # @return [String]
        attr_accessor :name
      
        # Output only. Whether or not this CustomClass is in the process of being
        # updated. This field is not used.
        # Corresponds to the JSON property `reconciling`
        # @return [Boolean]
        attr_accessor :reconciling
        alias_method :reconciling?, :reconciling
      
        # Output only. The CustomClass lifecycle state. This field is not used.
        # Corresponds to the JSON property `state`
        # @return [String]
        attr_accessor :state
      
        # Output only. System-assigned unique identifier for the CustomClass. This field
        # is not used.
        # Corresponds to the JSON property `uid`
        # @return [String]
        attr_accessor :uid
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @annotations = args[:annotations] if args.key?(:annotations)
          @custom_class_id = args[:custom_class_id] if args.key?(:custom_class_id)
          @delete_time = args[:delete_time] if args.key?(:delete_time)
          @display_name = args[:display_name] if args.key?(:display_name)
          @etag = args[:etag] if args.key?(:etag)
          @expire_time = args[:expire_time] if args.key?(:expire_time)
          @items = args[:items] if args.key?(:items)
          @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
          @kms_key_version_name = args[:kms_key_version_name] if args.key?(:kms_key_version_name)
          @name = args[:name] if args.key?(:name)
          @reconciling = args[:reconciling] if args.key?(:reconciling)
          @state = args[:state] if args.key?(:state)
          @uid = args[:uid] if args.key?(:uid)
        end
      end
      
      # A generic empty message that you can re-use to avoid defining duplicated empty
      # messages in your APIs. A typical example is to use it as the request or the
      # response type of an API method. For instance: service Foo ` rpc Bar(google.
      # protobuf.Empty) returns (google.protobuf.Empty); `
      class Empty
        include Google::Apis::Core::Hashable
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
        end
      end
      
      # A single replacement configuration.
      class Entry
        include Google::Apis::Core::Hashable
      
        # Whether the search is case sensitive.
        # Corresponds to the JSON property `caseSensitive`
        # @return [Boolean]
        attr_accessor :case_sensitive
        alias_method :case_sensitive?, :case_sensitive
      
        # What to replace with. Max length is 100 characters.
        # Corresponds to the JSON property `replace`
        # @return [String]
        attr_accessor :replace
      
        # What to replace. Max length is 100 characters.
        # Corresponds to the JSON property `search`
        # @return [String]
        attr_accessor :search
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @case_sensitive = args[:case_sensitive] if args.key?(:case_sensitive)
          @replace = args[:replace] if args.key?(:replace)
          @search = args[:search] if args.key?(:search)
        end
      end
      
      # Message returned to the client by the `ListCustomClasses` method.
      class ListCustomClassesResponse
        include Google::Apis::Core::Hashable
      
        # The custom classes.
        # Corresponds to the JSON property `customClasses`
        # @return [Array<Google::Apis::SpeechV1::CustomClass>]
        attr_accessor :custom_classes
      
        # A token, which can be sent as `page_token` to retrieve the next page. If this
        # field is omitted, there are no subsequent pages.
        # Corresponds to the JSON property `nextPageToken`
        # @return [String]
        attr_accessor :next_page_token
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @custom_classes = args[:custom_classes] if args.key?(:custom_classes)
          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
        end
      end
      
      # The response message for Operations.ListOperations.
      class ListOperationsResponse
        include Google::Apis::Core::Hashable
      
        # The standard List next-page token.
        # Corresponds to the JSON property `nextPageToken`
        # @return [String]
        attr_accessor :next_page_token
      
        # A list of operations that matches the specified filter in the request.
        # Corresponds to the JSON property `operations`
        # @return [Array<Google::Apis::SpeechV1::Operation>]
        attr_accessor :operations
      
        # Unordered list. Unreachable resources. Populated when the request sets `
        # ListOperationsRequest.return_partial_success` and reads across collections e.g.
        # when attempting to list all resources across all supported locations.
        # Corresponds to the JSON property `unreachable`
        # @return [Array<String>]
        attr_accessor :unreachable
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
          @operations = args[:operations] if args.key?(:operations)
          @unreachable = args[:unreachable] if args.key?(:unreachable)
        end
      end
      
      # Message returned to the client by the `ListPhraseSet` method.
      class ListPhraseSetResponse
        include Google::Apis::Core::Hashable
      
        # A token, which can be sent as `page_token` to retrieve the next page. If this
        # field is omitted, there are no subsequent pages.
        # Corresponds to the JSON property `nextPageToken`
        # @return [String]
        attr_accessor :next_page_token
      
        # The phrase set.
        # Corresponds to the JSON property `phraseSets`
        # @return [Array<Google::Apis::SpeechV1::PhraseSet>]
        attr_accessor :phrase_sets
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
          @phrase_sets = args[:phrase_sets] if args.key?(:phrase_sets)
        end
      end
      
      # Describes the progress of a long-running `LongRunningRecognize` call. It is
      # included in the `metadata` field of the `Operation` returned by the `
      # GetOperation` call of the `google::longrunning::Operations` service.
      class LongRunningRecognizeMetadata
        include Google::Apis::Core::Hashable
      
        # Time of the most recent processing update.
        # Corresponds to the JSON property `lastUpdateTime`
        # @return [String]
        attr_accessor :last_update_time
      
        # Approximate percentage of audio processed thus far. Guaranteed to be 100 when
        # the audio is fully processed and the results are available.
        # Corresponds to the JSON property `progressPercent`
        # @return [Fixnum]
        attr_accessor :progress_percent
      
        # Time when the request was received.
        # Corresponds to the JSON property `startTime`
        # @return [String]
        attr_accessor :start_time
      
        # Output only. The URI of the audio file being transcribed. Empty if the audio
        # was sent as byte content.
        # Corresponds to the JSON property `uri`
        # @return [String]
        attr_accessor :uri
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @last_update_time = args[:last_update_time] if args.key?(:last_update_time)
          @progress_percent = args[:progress_percent] if args.key?(:progress_percent)
          @start_time = args[:start_time] if args.key?(:start_time)
          @uri = args[:uri] if args.key?(:uri)
        end
      end
      
      # The top-level message sent by the client for the `LongRunningRecognize` method.
      class LongRunningRecognizeRequest
        include Google::Apis::Core::Hashable
      
        # Contains audio data in the encoding specified in the `RecognitionConfig`.
        # Either `content` or `uri` must be supplied. Supplying both or neither returns
        # google.rpc.Code.INVALID_ARGUMENT. See [content limits](https://cloud.google.
        # com/speech-to-text/quotas#content).
        # Corresponds to the JSON property `audio`
        # @return [Google::Apis::SpeechV1::RecognitionAudio]
        attr_accessor :audio
      
        # Provides information to the recognizer that specifies how to process the
        # request.
        # Corresponds to the JSON property `config`
        # @return [Google::Apis::SpeechV1::RecognitionConfig]
        attr_accessor :config
      
        # Specifies an optional destination for the recognition results.
        # Corresponds to the JSON property `outputConfig`
        # @return [Google::Apis::SpeechV1::TranscriptOutputConfig]
        attr_accessor :output_config
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @audio = args[:audio] if args.key?(:audio)
          @config = args[:config] if args.key?(:config)
          @output_config = args[:output_config] if args.key?(:output_config)
        end
      end
      
      # The only message returned to the client by the `LongRunningRecognize` method.
      # It contains the result as zero or more sequential `SpeechRecognitionResult`
      # messages. It is included in the `result.response` field of the `Operation`
      # returned by the `GetOperation` call of the `google::longrunning::Operations`
      # service.
      class LongRunningRecognizeResponse
        include Google::Apis::Core::Hashable
      
        # Specifies an optional destination for the recognition results.
        # Corresponds to the JSON property `outputConfig`
        # @return [Google::Apis::SpeechV1::TranscriptOutputConfig]
        attr_accessor :output_config
      
        # The `Status` type defines a logical error model that is suitable for different
        # programming environments, including REST APIs and RPC APIs. It is used by [
        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
        # data: error code, error message, and error details. You can find out more
        # about this error model and how to work with it in the [API Design Guide](https:
        # //cloud.google.com/apis/design/errors).
        # Corresponds to the JSON property `outputError`
        # @return [Google::Apis::SpeechV1::Status]
        attr_accessor :output_error
      
        # The ID associated with the request. This is a unique ID specific only to the
        # given request.
        # Corresponds to the JSON property `requestId`
        # @return [Fixnum]
        attr_accessor :request_id
      
        # Sequential list of transcription results corresponding to sequential portions
        # of audio.
        # Corresponds to the JSON property `results`
        # @return [Array<Google::Apis::SpeechV1::SpeechRecognitionResult>]
        attr_accessor :results
      
        # Information on speech adaptation use in results
        # Corresponds to the JSON property `speechAdaptationInfo`
        # @return [Google::Apis::SpeechV1::SpeechAdaptationInfo]
        attr_accessor :speech_adaptation_info
      
        # When available, billed audio seconds for the corresponding request.
        # Corresponds to the JSON property `totalBilledTime`
        # @return [String]
        attr_accessor :total_billed_time
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @output_config = args[:output_config] if args.key?(:output_config)
          @output_error = args[:output_error] if args.key?(:output_error)
          @request_id = args[:request_id] if args.key?(:request_id)
          @results = args[:results] if args.key?(:results)
          @speech_adaptation_info = args[:speech_adaptation_info] if args.key?(:speech_adaptation_info)
          @total_billed_time = args[:total_billed_time] if args.key?(:total_billed_time)
        end
      end
      
      # This resource represents a long-running operation that is the result of a
      # network API call.
      class Operation
        include Google::Apis::Core::Hashable
      
        # If the value is `false`, it means the operation is still in progress. If `true`
        # , the operation is completed, and either `error` or `response` is available.
        # Corresponds to the JSON property `done`
        # @return [Boolean]
        attr_accessor :done
        alias_method :done?, :done
      
        # The `Status` type defines a logical error model that is suitable for different
        # programming environments, including REST APIs and RPC APIs. It is used by [
        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
        # data: error code, error message, and error details. You can find out more
        # about this error model and how to work with it in the [API Design Guide](https:
        # //cloud.google.com/apis/design/errors).
        # Corresponds to the JSON property `error`
        # @return [Google::Apis::SpeechV1::Status]
        attr_accessor :error
      
        # Service-specific metadata associated with the operation. It typically contains
        # progress information and common metadata such as create time. Some services
        # might not provide such metadata. Any method that returns a long-running
        # operation should document the metadata type, if any.
        # Corresponds to the JSON property `metadata`
        # @return [Hash<String,Object>]
        attr_accessor :metadata
      
        # The server-assigned name, which is only unique within the same service that
        # originally returns it. If you use the default HTTP mapping, the `name` should
        # be a resource name ending with `operations/`unique_id``.
        # Corresponds to the JSON property `name`
        # @return [String]
        attr_accessor :name
      
        # The normal, successful response of the operation. If the original method
        # returns no data on success, such as `Delete`, the response is `google.protobuf.
        # Empty`. If the original method is standard `Get`/`Create`/`Update`, the
        # response should be the resource. For other methods, the response should have
        # the type `XxxResponse`, where `Xxx` is the original method name. For example,
        # if the original method name is `TakeSnapshot()`, the inferred response type is
        # `TakeSnapshotResponse`.
        # Corresponds to the JSON property `response`
        # @return [Hash<String,Object>]
        attr_accessor :response
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @done = args[:done] if args.key?(:done)
          @error = args[:error] if args.key?(:error)
          @metadata = args[:metadata] if args.key?(:metadata)
          @name = args[:name] if args.key?(:name)
          @response = args[:response] if args.key?(:response)
        end
      end
      
      # A phrases containing words and phrase "hints" so that the speech recognition
      # is more likely to recognize them. This can be used to improve the accuracy for
      # specific words and phrases, for example, if specific commands are typically
      # spoken by the user. This can also be used to add additional words to the
      # vocabulary of the recognizer. See [usage limits](https://cloud.google.com/
      # speech-to-text/quotas#content). List items can also include pre-built or
      # custom classes containing groups of words that represent common concepts that
      # occur in natural language. For example, rather than providing a phrase hint
      # for every month of the year (e.g. "i was born in january", "i was born in
      # febuary", ...), use the pre-built `$MONTH` class improves the likelihood of
      # correctly transcribing audio that includes months (e.g. "i was born in $month")
      # . To refer to pre-built classes, use the class' symbol prepended with `$` e.g.
      # `$MONTH`. To refer to custom classes that were defined inline in the request,
      # set the class's `custom_class_id` to a string unique to all class resources
      # and inline classes. Then use the class' id wrapped in $``...`` e.g. "$`my-
      # months`". To refer to custom classes resources, use the class' id wrapped in `$
      # ``` (e.g. `$`my-months``). Speech-to-Text supports three locations: `global`, `
      # us` (US North America), and `eu` (Europe). If you are calling the `speech.
      # googleapis.com` endpoint, use the `global` location. To specify a region, use
      # a [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints)
      # with matching `us` or `eu` location value.
      class Phrase
        include Google::Apis::Core::Hashable
      
        # Hint Boost. Overrides the boost set at the phrase set level. Positive value
        # will increase the probability that a specific phrase will be recognized over
        # other similar sounding phrases. The higher the boost, the higher the chance of
        # false positive recognition as well. Negative boost will simply be ignored.
        # Though `boost` can accept a wide range of positive values, most use cases are
        # best served with values between 0 and 20. We recommend using a binary search
        # approach to finding the optimal value for your use case as well as adding
        # phrases both with and without boost to your requests.
        # Corresponds to the JSON property `boost`
        # @return [Float]
        attr_accessor :boost
      
        # The phrase itself.
        # Corresponds to the JSON property `value`
        # @return [String]
        attr_accessor :value
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @boost = args[:boost] if args.key?(:boost)
          @value = args[:value] if args.key?(:value)
        end
      end
      
      # Provides "hints" to the speech recognizer to favor specific words and phrases
      # in the results.
      class PhraseSet
        include Google::Apis::Core::Hashable
      
        # Output only. Allows users to store small amounts of arbitrary data. Both the
        # key and the value must be 63 characters or less each. At most 100 annotations.
        # This field is not used.
        # Corresponds to the JSON property `annotations`
        # @return [Hash<String,String>]
        attr_accessor :annotations
      
        # Hint Boost. Positive value will increase the probability that a specific
        # phrase will be recognized over other similar sounding phrases. The higher the
        # boost, the higher the chance of false positive recognition as well. Negative
        # boost values would correspond to anti-biasing. Anti-biasing is not enabled, so
        # negative boost will simply be ignored. Though `boost` can accept a wide range
        # of positive values, most use cases are best served with values between 0 (
        # exclusive) and 20. We recommend using a binary search approach to finding the
        # optimal value for your use case as well as adding phrases both with and
        # without boost to your requests.
        # Corresponds to the JSON property `boost`
        # @return [Float]
        attr_accessor :boost
      
        # Output only. The time at which this resource was requested for deletion. This
        # field is not used.
        # Corresponds to the JSON property `deleteTime`
        # @return [String]
        attr_accessor :delete_time
      
        # Output only. User-settable, human-readable name for the PhraseSet. Must be 63
        # characters or less. This field is not used.
        # Corresponds to the JSON property `displayName`
        # @return [String]
        attr_accessor :display_name
      
        # Output only. This checksum is computed by the server based on the value of
        # other fields. This may be sent on update, undelete, and delete requests to
        # ensure the client has an up-to-date value before proceeding. This field is not
        # used.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # Output only. The time at which this resource will be purged. This field is not
        # used.
        # Corresponds to the JSON property `expireTime`
        # @return [String]
        attr_accessor :expire_time
      
        # Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-
        # hierarchy#keys) with which the content of the PhraseSet is encrypted. The
        # expected format is `projects/`project`/locations/`location`/keyRings/`key_ring`
        # /cryptoKeys/`crypto_key``.
        # Corresponds to the JSON property `kmsKeyName`
        # @return [String]
        attr_accessor :kms_key_name
      
        # Output only. The [KMS key version name](https://cloud.google.com/kms/docs/
        # resource-hierarchy#key_versions) with which content of the PhraseSet is
        # encrypted. The expected format is `projects/`project`/locations/`location`/
        # keyRings/`key_ring`/cryptoKeys/`crypto_key`/cryptoKeyVersions/`
        # crypto_key_version``.
        # Corresponds to the JSON property `kmsKeyVersionName`
        # @return [String]
        attr_accessor :kms_key_version_name
      
        # The resource name of the phrase set.
        # Corresponds to the JSON property `name`
        # @return [String]
        attr_accessor :name
      
        # A list of word and phrases.
        # Corresponds to the JSON property `phrases`
        # @return [Array<Google::Apis::SpeechV1::Phrase>]
        attr_accessor :phrases
      
        # Output only. Whether or not this PhraseSet is in the process of being updated.
        # This field is not used.
        # Corresponds to the JSON property `reconciling`
        # @return [Boolean]
        attr_accessor :reconciling
        alias_method :reconciling?, :reconciling
      
        # Output only. The CustomClass lifecycle state. This field is not used.
        # Corresponds to the JSON property `state`
        # @return [String]
        attr_accessor :state
      
        # Output only. System-assigned unique identifier for the PhraseSet. This field
        # is not used.
        # Corresponds to the JSON property `uid`
        # @return [String]
        attr_accessor :uid
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @annotations = args[:annotations] if args.key?(:annotations)
          @boost = args[:boost] if args.key?(:boost)
          @delete_time = args[:delete_time] if args.key?(:delete_time)
          @display_name = args[:display_name] if args.key?(:display_name)
          @etag = args[:etag] if args.key?(:etag)
          @expire_time = args[:expire_time] if args.key?(:expire_time)
          @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
          @kms_key_version_name = args[:kms_key_version_name] if args.key?(:kms_key_version_name)
          @name = args[:name] if args.key?(:name)
          @phrases = args[:phrases] if args.key?(:phrases)
          @reconciling = args[:reconciling] if args.key?(:reconciling)
          @state = args[:state] if args.key?(:state)
          @uid = args[:uid] if args.key?(:uid)
        end
      end
      
      # Contains audio data in the encoding specified in the `RecognitionConfig`.
      # Either `content` or `uri` must be supplied. Supplying both or neither returns
      # google.rpc.Code.INVALID_ARGUMENT. See [content limits](https://cloud.google.
      # com/speech-to-text/quotas#content).
      class RecognitionAudio
        include Google::Apis::Core::Hashable
      
        # The audio data bytes encoded as specified in `RecognitionConfig`. Note: as
        # with all bytes fields, proto buffers use a pure binary representation, whereas
        # JSON representations use base64.
        # Corresponds to the JSON property `content`
        # NOTE: Values are automatically base64 encoded/decoded in the client library.
        # @return [String]
        attr_accessor :content
      
        # URI that points to a file that contains audio data bytes as specified in `
        # RecognitionConfig`. The file must not be compressed (for example, gzip).
        # Currently, only Google Cloud Storage URIs are supported, which must be
        # specified in the following format: `gs://bucket_name/object_name` (other URI
        # formats return google.rpc.Code.INVALID_ARGUMENT). For more information, see [
        # Request URIs](https://cloud.google.com/storage/docs/reference-uris).
        # Corresponds to the JSON property `uri`
        # @return [String]
        attr_accessor :uri
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @content = args[:content] if args.key?(:content)
          @uri = args[:uri] if args.key?(:uri)
        end
      end
      
      # Provides information to the recognizer that specifies how to process the
      # request.
      class RecognitionConfig
        include Google::Apis::Core::Hashable
      
        # Speech adaptation configuration.
        # Corresponds to the JSON property `adaptation`
        # @return [Google::Apis::SpeechV1::SpeechAdaptation]
        attr_accessor :adaptation
      
        # A list of up to 3 additional [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.
        # txt) language tags, listing possible alternative languages of the supplied
        # audio. See [Language Support](https://cloud.google.com/speech-to-text/docs/
        # languages) for a list of the currently supported language codes. If
        # alternative languages are listed, recognition result will contain recognition
        # in the most likely language detected including the main language_code. The
        # recognition result will include the language tag of the language detected in
        # the audio. Note: This feature is only supported for Voice Command and Voice
        # Search use cases and performance may vary for other use cases (e.g., phone
        # call transcription).
        # Corresponds to the JSON property `alternativeLanguageCodes`
        # @return [Array<String>]
        attr_accessor :alternative_language_codes
      
        # The number of channels in the input audio data. ONLY set this for MULTI-
        # CHANNEL recognition. Valid values for LINEAR16, OGG_OPUS and FLAC are `1`-`8`.
        # Valid value for MULAW, AMR, AMR_WB and SPEEX_WITH_HEADER_BYTE is only `1`. If `
        # 0` or omitted, defaults to one channel (mono). Note: We only recognize the
        # first channel by default. To perform independent recognition on each channel
        # set `enable_separate_recognition_per_channel` to 'true'.
        # Corresponds to the JSON property `audioChannelCount`
        # @return [Fixnum]
        attr_accessor :audio_channel_count
      
        # Config to enable speaker diarization.
        # Corresponds to the JSON property `diarizationConfig`
        # @return [Google::Apis::SpeechV1::SpeakerDiarizationConfig]
        attr_accessor :diarization_config
      
        # If 'true', adds punctuation to recognition result hypotheses. This feature is
        # only available in select languages. Setting this for requests in other
        # languages has no effect at all. The default 'false' value does not add
        # punctuation to result hypotheses.
        # Corresponds to the JSON property `enableAutomaticPunctuation`
        # @return [Boolean]
        attr_accessor :enable_automatic_punctuation
        alias_method :enable_automatic_punctuation?, :enable_automatic_punctuation
      
        # This needs to be set to `true` explicitly and `audio_channel_count` > 1 to get
        # each channel recognized separately. The recognition result will contain a `
        # channel_tag` field to state which channel that result belongs to. If this is
        # not true, we will only recognize the first channel. The request is billed
        # cumulatively for all channels recognized: `audio_channel_count` multiplied by
        # the length of the audio.
        # Corresponds to the JSON property `enableSeparateRecognitionPerChannel`
        # @return [Boolean]
        attr_accessor :enable_separate_recognition_per_channel
        alias_method :enable_separate_recognition_per_channel?, :enable_separate_recognition_per_channel
      
        # The spoken emoji behavior for the call If not set, uses default behavior based
        # on model of choice If 'true', adds spoken emoji formatting for the request.
        # This will replace spoken emojis with the corresponding Unicode symbols in the
        # final transcript. If 'false', spoken emojis are not replaced.
        # Corresponds to the JSON property `enableSpokenEmojis`
        # @return [Boolean]
        attr_accessor :enable_spoken_emojis
        alias_method :enable_spoken_emojis?, :enable_spoken_emojis
      
        # The spoken punctuation behavior for the call If not set, uses default behavior
        # based on model of choice e.g. command_and_search will enable spoken
        # punctuation by default If 'true', replaces spoken punctuation with the
        # corresponding symbols in the request. For example, "how are you question mark"
        # becomes "how are you?". See https://cloud.google.com/speech-to-text/docs/
        # spoken-punctuation for support. If 'false', spoken punctuation is not replaced.
        # Corresponds to the JSON property `enableSpokenPunctuation`
        # @return [Boolean]
        attr_accessor :enable_spoken_punctuation
        alias_method :enable_spoken_punctuation?, :enable_spoken_punctuation
      
        # If `true`, the top result includes a list of words and the confidence for
        # those words. If `false`, no word-level confidence information is returned. The
        # default is `false`.
        # Corresponds to the JSON property `enableWordConfidence`
        # @return [Boolean]
        attr_accessor :enable_word_confidence
        alias_method :enable_word_confidence?, :enable_word_confidence
      
        # If `true`, the top result includes a list of words and the start and end time
        # offsets (timestamps) for those words. If `false`, no word-level time offset
        # information is returned. The default is `false`.
        # Corresponds to the JSON property `enableWordTimeOffsets`
        # @return [Boolean]
        attr_accessor :enable_word_time_offsets
        alias_method :enable_word_time_offsets?, :enable_word_time_offsets
      
        # Encoding of audio data sent in all `RecognitionAudio` messages. This field is
        # optional for `FLAC` and `WAV` audio files and required for all other audio
        # formats. For details, see AudioEncoding.
        # Corresponds to the JSON property `encoding`
        # @return [String]
        attr_accessor :encoding
      
        # Required. The language of the supplied audio as a [BCP-47](https://www.rfc-
        # editor.org/rfc/bcp/bcp47.txt) language tag. Example: "en-US". See [Language
        # Support](https://cloud.google.com/speech-to-text/docs/languages) for a list of
        # the currently supported language codes.
        # Corresponds to the JSON property `languageCode`
        # @return [String]
        attr_accessor :language_code
      
        # Maximum number of recognition hypotheses to be returned. Specifically, the
        # maximum number of `SpeechRecognitionAlternative` messages within each `
        # SpeechRecognitionResult`. The server may return fewer than `max_alternatives`.
        # Valid values are `0`-`30`. A value of `0` or `1` will return a maximum of one.
        # If omitted, will return a maximum of one.
        # Corresponds to the JSON property `maxAlternatives`
        # @return [Fixnum]
        attr_accessor :max_alternatives
      
        # Description of audio data to be recognized.
        # Corresponds to the JSON property `metadata`
        # @return [Google::Apis::SpeechV1::RecognitionMetadata]
        attr_accessor :metadata
      
        # Which model to select for the given request. Select the model best suited to
        # your domain to get best results. If a model is not explicitly specified, then
        # we auto-select a model based on the parameters in the RecognitionConfig. *
        # Model* *Description* latest_long Best for long form content like media or
        # conversation. latest_short Best for short form content like commands or single
        # shot directed speech. command_and_search Best for short queries such as voice
        # commands or voice search. phone_call Best for audio that originated from a
        # phone call (typically recorded at an 8khz sampling rate). video Best for audio
        # that originated from video or includes multiple speakers. Ideally the audio is
        # recorded at a 16khz or greater sampling rate. This is a premium model that
        # costs more than the standard rate. default Best for audio that is not one of
        # the specific audio models. For example, long-form audio. Ideally the audio is
        # high-fidelity, recorded at a 16khz or greater sampling rate.
        # medical_conversation Best for audio that originated from a conversation
        # between a medical provider and patient. medical_dictation Best for audio that
        # originated from dictation notes by a medical provider.
        # Corresponds to the JSON property `model`
        # @return [String]
        attr_accessor :model
      
        # If set to `true`, the server will attempt to filter out profanities, replacing
        # all but the initial character in each filtered word with asterisks, e.g. "f***"
        # . If set to `false` or omitted, profanities won't be filtered out.
        # Corresponds to the JSON property `profanityFilter`
        # @return [Boolean]
        attr_accessor :profanity_filter
        alias_method :profanity_filter?, :profanity_filter
      
        # Sample rate in Hertz of the audio data sent in all `RecognitionAudio` messages.
        # Valid values are: 8000-48000. 16000 is optimal. For best results, set the
        # sampling rate of the audio source to 16000 Hz. If that's not possible, use the
        # native sample rate of the audio source (instead of re-sampling). This field is
        # optional for FLAC and WAV audio files, but is required for all other audio
        # formats. For details, see AudioEncoding.
        # Corresponds to the JSON property `sampleRateHertz`
        # @return [Fixnum]
        attr_accessor :sample_rate_hertz
      
        # Array of SpeechContext. A means to provide context to assist the speech
        # recognition. For more information, see [speech adaptation](https://cloud.
        # google.com/speech-to-text/docs/adaptation).
        # Corresponds to the JSON property `speechContexts`
        # @return [Array<Google::Apis::SpeechV1::SpeechContext>]
        attr_accessor :speech_contexts
      
        # Transcription normalization configuration. Use transcription normalization to
        # automatically replace parts of the transcript with phrases of your choosing.
        # For StreamingRecognize, this normalization only applies to stable partial
        # transcripts (stability > 0.8) and final transcripts.
        # Corresponds to the JSON property `transcriptNormalization`
        # @return [Google::Apis::SpeechV1::TranscriptNormalization]
        attr_accessor :transcript_normalization
      
        # Set to true to use an enhanced model for speech recognition. If `use_enhanced`
        # is set to true and the `model` field is not set, then an appropriate enhanced
        # model is chosen if an enhanced model exists for the audio. If `use_enhanced`
        # is true and an enhanced version of the specified model does not exist, then
        # the speech is recognized using the standard version of the specified model.
        # Corresponds to the JSON property `useEnhanced`
        # @return [Boolean]
        attr_accessor :use_enhanced
        alias_method :use_enhanced?, :use_enhanced
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @adaptation = args[:adaptation] if args.key?(:adaptation)
          @alternative_language_codes = args[:alternative_language_codes] if args.key?(:alternative_language_codes)
          @audio_channel_count = args[:audio_channel_count] if args.key?(:audio_channel_count)
          @diarization_config = args[:diarization_config] if args.key?(:diarization_config)
          @enable_automatic_punctuation = args[:enable_automatic_punctuation] if args.key?(:enable_automatic_punctuation)
          @enable_separate_recognition_per_channel = args[:enable_separate_recognition_per_channel] if args.key?(:enable_separate_recognition_per_channel)
          @enable_spoken_emojis = args[:enable_spoken_emojis] if args.key?(:enable_spoken_emojis)
          @enable_spoken_punctuation = args[:enable_spoken_punctuation] if args.key?(:enable_spoken_punctuation)
          @enable_word_confidence = args[:enable_word_confidence] if args.key?(:enable_word_confidence)
          @enable_word_time_offsets = args[:enable_word_time_offsets] if args.key?(:enable_word_time_offsets)
          @encoding = args[:encoding] if args.key?(:encoding)
          @language_code = args[:language_code] if args.key?(:language_code)
          @max_alternatives = args[:max_alternatives] if args.key?(:max_alternatives)
          @metadata = args[:metadata] if args.key?(:metadata)
          @model = args[:model] if args.key?(:model)
          @profanity_filter = args[:profanity_filter] if args.key?(:profanity_filter)
          @sample_rate_hertz = args[:sample_rate_hertz] if args.key?(:sample_rate_hertz)
          @speech_contexts = args[:speech_contexts] if args.key?(:speech_contexts)
          @transcript_normalization = args[:transcript_normalization] if args.key?(:transcript_normalization)
          @use_enhanced = args[:use_enhanced] if args.key?(:use_enhanced)
        end
      end
      
      # Description of audio data to be recognized.
      class RecognitionMetadata
        include Google::Apis::Core::Hashable
      
        # Description of the content. Eg. "Recordings of federal supreme court hearings
        # from 2012".
        # Corresponds to the JSON property `audioTopic`
        # @return [String]
        attr_accessor :audio_topic
      
        # The industry vertical to which this speech recognition request most closely
        # applies. This is most indicative of the topics contained in the audio. Use the
        # 6-digit NAICS code to identify the industry vertical - see https://www.naics.
        # com/search/.
        # Corresponds to the JSON property `industryNaicsCodeOfAudio`
        # @return [Fixnum]
        attr_accessor :industry_naics_code_of_audio
      
        # The use case most closely describing the audio content to be recognized.
        # Corresponds to the JSON property `interactionType`
        # @return [String]
        attr_accessor :interaction_type
      
        # The audio type that most closely describes the audio being recognized.
        # Corresponds to the JSON property `microphoneDistance`
        # @return [String]
        attr_accessor :microphone_distance
      
        # The original media the speech was recorded on.
        # Corresponds to the JSON property `originalMediaType`
        # @return [String]
        attr_accessor :original_media_type
      
        # Mime type of the original audio file. For example `audio/m4a`, `audio/x-alaw-
        # basic`, `audio/mp3`, `audio/3gpp`. A list of possible audio mime types is
        # maintained at http://www.iana.org/assignments/media-types/media-types.xhtml#
        # audio
        # Corresponds to the JSON property `originalMimeType`
        # @return [String]
        attr_accessor :original_mime_type
      
        # The device used to make the recording. Examples 'Nexus 5X' or 'Polycom
        # SoundStation IP 6000' or 'POTS' or 'VoIP' or 'Cardioid Microphone'.
        # Corresponds to the JSON property `recordingDeviceName`
        # @return [String]
        attr_accessor :recording_device_name
      
        # The type of device the speech was recorded with.
        # Corresponds to the JSON property `recordingDeviceType`
        # @return [String]
        attr_accessor :recording_device_type
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @audio_topic = args[:audio_topic] if args.key?(:audio_topic)
          @industry_naics_code_of_audio = args[:industry_naics_code_of_audio] if args.key?(:industry_naics_code_of_audio)
          @interaction_type = args[:interaction_type] if args.key?(:interaction_type)
          @microphone_distance = args[:microphone_distance] if args.key?(:microphone_distance)
          @original_media_type = args[:original_media_type] if args.key?(:original_media_type)
          @original_mime_type = args[:original_mime_type] if args.key?(:original_mime_type)
          @recording_device_name = args[:recording_device_name] if args.key?(:recording_device_name)
          @recording_device_type = args[:recording_device_type] if args.key?(:recording_device_type)
        end
      end
      
      # The top-level message sent by the client for the `Recognize` method.
      class RecognizeRequest
        include Google::Apis::Core::Hashable
      
        # Contains audio data in the encoding specified in the `RecognitionConfig`.
        # Either `content` or `uri` must be supplied. Supplying both or neither returns
        # google.rpc.Code.INVALID_ARGUMENT. See [content limits](https://cloud.google.
        # com/speech-to-text/quotas#content).
        # Corresponds to the JSON property `audio`
        # @return [Google::Apis::SpeechV1::RecognitionAudio]
        attr_accessor :audio
      
        # Provides information to the recognizer that specifies how to process the
        # request.
        # Corresponds to the JSON property `config`
        # @return [Google::Apis::SpeechV1::RecognitionConfig]
        attr_accessor :config
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @audio = args[:audio] if args.key?(:audio)
          @config = args[:config] if args.key?(:config)
        end
      end
      
      # The only message returned to the client by the `Recognize` method. It contains
      # the result as zero or more sequential `SpeechRecognitionResult` messages.
      class RecognizeResponse
        include Google::Apis::Core::Hashable
      
        # The ID associated with the request. This is a unique ID specific only to the
        # given request.
        # Corresponds to the JSON property `requestId`
        # @return [Fixnum]
        attr_accessor :request_id
      
        # Sequential list of transcription results corresponding to sequential portions
        # of audio.
        # Corresponds to the JSON property `results`
        # @return [Array<Google::Apis::SpeechV1::SpeechRecognitionResult>]
        attr_accessor :results
      
        # Information on speech adaptation use in results
        # Corresponds to the JSON property `speechAdaptationInfo`
        # @return [Google::Apis::SpeechV1::SpeechAdaptationInfo]
        attr_accessor :speech_adaptation_info
      
        # When available, billed audio seconds for the corresponding request.
        # Corresponds to the JSON property `totalBilledTime`
        # @return [String]
        attr_accessor :total_billed_time
      
        # Whether request used legacy asr models (was not automatically migrated to use
        # conformer models).
        # Corresponds to the JSON property `usingLegacyModels`
        # @return [Boolean]
        attr_accessor :using_legacy_models
        alias_method :using_legacy_models?, :using_legacy_models
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @request_id = args[:request_id] if args.key?(:request_id)
          @results = args[:results] if args.key?(:results)
          @speech_adaptation_info = args[:speech_adaptation_info] if args.key?(:speech_adaptation_info)
          @total_billed_time = args[:total_billed_time] if args.key?(:total_billed_time)
          @using_legacy_models = args[:using_legacy_models] if args.key?(:using_legacy_models)
        end
      end
      
      # Config to enable speaker diarization.
      class SpeakerDiarizationConfig
        include Google::Apis::Core::Hashable
      
        # If 'true', enables speaker detection for each recognized word in the top
        # alternative of the recognition result using a speaker_label provided in the
        # WordInfo.
        # Corresponds to the JSON property `enableSpeakerDiarization`
        # @return [Boolean]
        attr_accessor :enable_speaker_diarization
        alias_method :enable_speaker_diarization?, :enable_speaker_diarization
      
        # Maximum number of speakers in the conversation. This range gives you more
        # flexibility by allowing the system to automatically determine the correct
        # number of speakers. If not set, the default value is 6.
        # Corresponds to the JSON property `maxSpeakerCount`
        # @return [Fixnum]
        attr_accessor :max_speaker_count
      
        # Minimum number of speakers in the conversation. This range gives you more
        # flexibility by allowing the system to automatically determine the correct
        # number of speakers. If not set, the default value is 2.
        # Corresponds to the JSON property `minSpeakerCount`
        # @return [Fixnum]
        attr_accessor :min_speaker_count
      
        # Output only. Unused.
        # Corresponds to the JSON property `speakerTag`
        # @return [Fixnum]
        attr_accessor :speaker_tag
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @enable_speaker_diarization = args[:enable_speaker_diarization] if args.key?(:enable_speaker_diarization)
          @max_speaker_count = args[:max_speaker_count] if args.key?(:max_speaker_count)
          @min_speaker_count = args[:min_speaker_count] if args.key?(:min_speaker_count)
          @speaker_tag = args[:speaker_tag] if args.key?(:speaker_tag)
        end
      end
      
      # Speech adaptation configuration.
      class SpeechAdaptation
        include Google::Apis::Core::Hashable
      
        # Augmented Backus-Naur form (ABNF) is a standardized grammar notation comprised
        # by a set of derivation rules. See specifications: https://www.w3.org/TR/speech-
        # grammar
        # Corresponds to the JSON property `abnfGrammar`
        # @return [Google::Apis::SpeechV1::AbnfGrammar]
        attr_accessor :abnf_grammar
      
        # A collection of custom classes. To specify the classes inline, leave the class'
        # `name` blank and fill in the rest of its fields, giving it a unique `
        # custom_class_id`. Refer to the inline defined class in phrase hints by its `
        # custom_class_id`.
        # Corresponds to the JSON property `customClasses`
        # @return [Array<Google::Apis::SpeechV1::CustomClass>]
        attr_accessor :custom_classes
      
        # A collection of phrase set resource names to use.
        # Corresponds to the JSON property `phraseSetReferences`
        # @return [Array<String>]
        attr_accessor :phrase_set_references
      
        # A collection of phrase sets. To specify the hints inline, leave the phrase set'
        # s `name` blank and fill in the rest of its fields. Any phrase set can use any
        # custom class.
        # Corresponds to the JSON property `phraseSets`
        # @return [Array<Google::Apis::SpeechV1::PhraseSet>]
        attr_accessor :phrase_sets
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @abnf_grammar = args[:abnf_grammar] if args.key?(:abnf_grammar)
          @custom_classes = args[:custom_classes] if args.key?(:custom_classes)
          @phrase_set_references = args[:phrase_set_references] if args.key?(:phrase_set_references)
          @phrase_sets = args[:phrase_sets] if args.key?(:phrase_sets)
        end
      end
      
      # Information on speech adaptation use in results
      class SpeechAdaptationInfo
        include Google::Apis::Core::Hashable
      
        # Whether there was a timeout when applying speech adaptation. If true,
        # adaptation had no effect in the response transcript.
        # Corresponds to the JSON property `adaptationTimeout`
        # @return [Boolean]
        attr_accessor :adaptation_timeout
        alias_method :adaptation_timeout?, :adaptation_timeout
      
        # If set, returns a message specifying which part of the speech adaptation
        # request timed out.
        # Corresponds to the JSON property `timeoutMessage`
        # @return [String]
        attr_accessor :timeout_message
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @adaptation_timeout = args[:adaptation_timeout] if args.key?(:adaptation_timeout)
          @timeout_message = args[:timeout_message] if args.key?(:timeout_message)
        end
      end
      
      # Provides "hints" to the speech recognizer to favor specific words and phrases
      # in the results.
      class SpeechContext
        include Google::Apis::Core::Hashable
      
        # Hint Boost. Positive value will increase the probability that a specific
        # phrase will be recognized over other similar sounding phrases. The higher the
        # boost, the higher the chance of false positive recognition as well. Negative
        # boost values would correspond to anti-biasing. Anti-biasing is not enabled, so
        # negative boost will simply be ignored. Though `boost` can accept a wide range
        # of positive values, most use cases are best served with values between 0 and
        # 20. We recommend using a binary search approach to finding the optimal value
        # for your use case.
        # Corresponds to the JSON property `boost`
        # @return [Float]
        attr_accessor :boost
      
        # A list of strings containing words and phrases "hints" so that the speech
        # recognition is more likely to recognize them. This can be used to improve the
        # accuracy for specific words and phrases, for example, if specific commands are
        # typically spoken by the user. This can also be used to add additional words to
        # the vocabulary of the recognizer. See [usage limits](https://cloud.google.com/
        # speech-to-text/quotas#content). List items can also be set to classes for
        # groups of words that represent common concepts that occur in natural language.
        # For example, rather than providing phrase hints for every month of the year,
        # using the $MONTH class improves the likelihood of correctly transcribing audio
        # that includes months.
        # Corresponds to the JSON property `phrases`
        # @return [Array<String>]
        attr_accessor :phrases
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @boost = args[:boost] if args.key?(:boost)
          @phrases = args[:phrases] if args.key?(:phrases)
        end
      end
      
      # Alternative hypotheses (a.k.a. n-best list).
      class SpeechRecognitionAlternative
        include Google::Apis::Core::Hashable
      
        # The confidence estimate between 0.0 and 1.0. A higher number indicates an
        # estimated greater likelihood that the recognized words are correct. This field
        # is set only for the top alternative of a non-streaming result or, of a
        # streaming result where `is_final=true`. This field is not guaranteed to be
        # accurate and users should not rely on it to be always provided. The default of
        # 0.0 is a sentinel value indicating `confidence` was not set.
        # Corresponds to the JSON property `confidence`
        # @return [Float]
        attr_accessor :confidence
      
        # Transcript text representing the words that the user spoke. In languages that
        # use spaces to separate words, the transcript might have a leading space if it
        # isn't the first result. You can concatenate each result to obtain the full
        # transcript without using a separator.
        # Corresponds to the JSON property `transcript`
        # @return [String]
        attr_accessor :transcript
      
        # A list of word-specific information for each recognized word. Note: When `
        # enable_speaker_diarization` is true, you will see all the words from the
        # beginning of the audio.
        # Corresponds to the JSON property `words`
        # @return [Array<Google::Apis::SpeechV1::WordInfo>]
        attr_accessor :words
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @confidence = args[:confidence] if args.key?(:confidence)
          @transcript = args[:transcript] if args.key?(:transcript)
          @words = args[:words] if args.key?(:words)
        end
      end
      
      # A speech recognition result corresponding to a portion of the audio.
      class SpeechRecognitionResult
        include Google::Apis::Core::Hashable
      
        # May contain one or more recognition hypotheses (up to the maximum specified in
        # `max_alternatives`). These alternatives are ordered in terms of accuracy, with
        # the top (first) alternative being the most probable, as ranked by the
        # recognizer.
        # Corresponds to the JSON property `alternatives`
        # @return [Array<Google::Apis::SpeechV1::SpeechRecognitionAlternative>]
        attr_accessor :alternatives
      
        # For multi-channel audio, this is the channel number corresponding to the
        # recognized result for the audio from that channel. For audio_channel_count = N,
        # its output values can range from '1' to 'N'.
        # Corresponds to the JSON property `channelTag`
        # @return [Fixnum]
        attr_accessor :channel_tag
      
        # Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
        # language tag of the language in this result. This language code was detected
        # to have the most likelihood of being spoken in the audio.
        # Corresponds to the JSON property `languageCode`
        # @return [String]
        attr_accessor :language_code
      
        # Time offset of the end of this result relative to the beginning of the audio.
        # Corresponds to the JSON property `resultEndTime`
        # @return [String]
        attr_accessor :result_end_time
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @alternatives = args[:alternatives] if args.key?(:alternatives)
          @channel_tag = args[:channel_tag] if args.key?(:channel_tag)
          @language_code = args[:language_code] if args.key?(:language_code)
          @result_end_time = args[:result_end_time] if args.key?(:result_end_time)
        end
      end
      
      # The `Status` type defines a logical error model that is suitable for different
      # programming environments, including REST APIs and RPC APIs. It is used by [
      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
      # data: error code, error message, and error details. You can find out more
      # about this error model and how to work with it in the [API Design Guide](https:
      # //cloud.google.com/apis/design/errors).
      class Status
        include Google::Apis::Core::Hashable
      
        # The status code, which should be an enum value of google.rpc.Code.
        # Corresponds to the JSON property `code`
        # @return [Fixnum]
        attr_accessor :code
      
        # A list of messages that carry the error details. There is a common set of
        # message types for APIs to use.
        # Corresponds to the JSON property `details`
        # @return [Array<Hash<String,Object>>]
        attr_accessor :details
      
        # A developer-facing error message, which should be in English. Any user-facing
        # error message should be localized and sent in the google.rpc.Status.details
        # field, or localized by the client.
        # Corresponds to the JSON property `message`
        # @return [String]
        attr_accessor :message
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @code = args[:code] if args.key?(:code)
          @details = args[:details] if args.key?(:details)
          @message = args[:message] if args.key?(:message)
        end
      end
      
      # Transcription normalization configuration. Use transcription normalization to
      # automatically replace parts of the transcript with phrases of your choosing.
      # For StreamingRecognize, this normalization only applies to stable partial
      # transcripts (stability > 0.8) and final transcripts.
      class TranscriptNormalization
        include Google::Apis::Core::Hashable
      
        # A list of replacement entries. We will perform replacement with one entry at a
        # time. For example, the second entry in ["cat" => "dog", "mountain cat" => "
        # mountain dog"] will never be applied because we will always process the first
        # entry before it. At most 100 entries.
        # Corresponds to the JSON property `entries`
        # @return [Array<Google::Apis::SpeechV1::Entry>]
        attr_accessor :entries
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @entries = args[:entries] if args.key?(:entries)
        end
      end
      
      # Specifies an optional destination for the recognition results.
      class TranscriptOutputConfig
        include Google::Apis::Core::Hashable
      
        # Specifies a Cloud Storage URI for the recognition results. Must be specified
        # in the format: `gs://bucket_name/object_name`, and the bucket must already
        # exist.
        # Corresponds to the JSON property `gcsUri`
        # @return [String]
        attr_accessor :gcs_uri
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @gcs_uri = args[:gcs_uri] if args.key?(:gcs_uri)
        end
      end
      
      # Word-specific information for recognized words.
      class WordInfo
        include Google::Apis::Core::Hashable
      
        # The confidence estimate between 0.0 and 1.0. A higher number indicates an
        # estimated greater likelihood that the recognized words are correct. This field
        # is set only for the top alternative of a non-streaming result or, of a
        # streaming result where `is_final=true`. This field is not guaranteed to be
        # accurate and users should not rely on it to be always provided. The default of
        # 0.0 is a sentinel value indicating `confidence` was not set.
        # Corresponds to the JSON property `confidence`
        # @return [Float]
        attr_accessor :confidence
      
        # Time offset relative to the beginning of the audio, and corresponding to the
        # end of the spoken word. This field is only set if `enable_word_time_offsets=
        # true` and only in the top hypothesis. This is an experimental feature and the
        # accuracy of the time offset can vary.
        # Corresponds to the JSON property `endTime`
        # @return [String]
        attr_accessor :end_time
      
        # Output only. A label value assigned for every unique speaker within the audio.
        # This field specifies which speaker was detected to have spoken this word. For
        # some models, like medical_conversation this can be actual speaker role, for
        # example "patient" or "provider", but generally this would be a number
        # identifying a speaker. This field is only set if enable_speaker_diarization = '
        # true' and only for the top alternative.
        # Corresponds to the JSON property `speakerLabel`
        # @return [String]
        attr_accessor :speaker_label
      
        # Output only. A distinct integer value is assigned for every speaker within the
        # audio. This field specifies which one of those speakers was detected to have
        # spoken this word. Value ranges from '1' to diarization_speaker_count.
        # speaker_tag is set if enable_speaker_diarization = 'true' and only for the top
        # alternative. Note: Use speaker_label instead.
        # Corresponds to the JSON property `speakerTag`
        # @return [Fixnum]
        attr_accessor :speaker_tag
      
        # Time offset relative to the beginning of the audio, and corresponding to the
        # start of the spoken word. This field is only set if `enable_word_time_offsets=
        # true` and only in the top hypothesis. This is an experimental feature and the
        # accuracy of the time offset can vary.
        # Corresponds to the JSON property `startTime`
        # @return [String]
        attr_accessor :start_time
      
        # The word corresponding to this set of information.
        # Corresponds to the JSON property `word`
        # @return [String]
        attr_accessor :word
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @confidence = args[:confidence] if args.key?(:confidence)
          @end_time = args[:end_time] if args.key?(:end_time)
          @speaker_label = args[:speaker_label] if args.key?(:speaker_label)
          @speaker_tag = args[:speaker_tag] if args.key?(:speaker_tag)
          @start_time = args[:start_time] if args.key?(:start_time)
          @word = args[:word] if args.key?(:word)
        end
      end
    end
  end
end
